home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / editor / wf314.zip / WF311DOC.ZIP / DOCS / WF.013 < prev    next >
Text File  |  1992-01-31  |  17KB  |  376 lines
  1. .f3                              - # -              Chapter 13 - Macros
  2. .rm70
  3. .tc
  4. .tc1
  5. .tc 13. MACROS ............................................#
  6. CHAPTER 13   MACROS
  7.  
  8. .imMacros
  9. .ix   Definition
  10. .irKeyboard;Keyboard Macros see Macros
  11. A macro is essentially a pre recorded sequence of key strokes that you
  12. wish to execute. Each macro may contain up to 255 characters, and is
  13. stored in a macro file. Each macro file has room for 36 macros. Several
  14. macro files are provided with the Word Fugue package. They all end
  15. with the extension .MAC  The standard one WF.MAC will always be loaded
  16. on startup.
  17.  
  18. The files provided are:-
  19. .ix   Standard macro files
  20.  
  21. WF.MAC     standard macros for word processing
  22.  
  23. SINGLE.MAC definitions for box drawing characters, concentrating on
  24.            single lines.
  25.  
  26. DOUBLE.MAC definitions for box drawing characters, concentrating on
  27.            double lines.
  28.  
  29. GREEK.MAC  allows access to the Greek character set (as supported by
  30.            the IBM PC)
  31.  
  32. EUROPE.MAC allows access to the European characters supported by the
  33.            IBM PC.
  34.  
  35. PASCAL.MAC assorted macros for pascal programmers.
  36.  
  37. Each macro has an identifying character that is used to activate it or
  38. replay it. These identifiers are the numbers 0 to 9, and the letters A
  39. to Z. Lowercase and uppercase letters are treated the same. You can
  40. only load one macro file at a time, but you can use macros to load
  41. other macro files and execute macros from there. In addition you can
  42. load a different macro file to execute a single command, and the
  43. return to your original macro file.
  44.  
  45. You can have a set of macro files in each directory you use if
  46. necessary, since Word Fugue looks in the current directory when
  47. loading a macro file. When first started, Word Fugue will look for the
  48. macro file WF.MAC in the default directory and if it does not find it
  49. there, will look in the defined home directory.
  50.  
  51. .tc    Recording A Macro ..................................#
  52. Recording A Macro
  53. .ix   Recording
  54.  
  55. Before you can use macros, you need to set them up. The simplest
  56. method is to record a sequence of key strokes. You achieve this by
  57. pressing Alt R at the start of the sequence, and Alt R again when you
  58. have finished. You will be prompted with a list of macros in the macro
  59. file, and you will be asked to choose one to use as the repository of
  60. the characters you have just recorded. Use the cursor movement keys to
  61. highlight the macro you wish to store the keystrokes in, and press
  62. Return. You will then be prompted for a name for the macro, which is
  63. displayed whenever a list of available macros is displayed. Enter
  64. something meaningful, and if possible, prefix it with the letter that
  65. will be used to activate it.
  66.  
  67. .CP6
  68. You need to be sure that the sequence of keystrokes you enter is
  69. correct, since they will be replayed exactly as you entered them.
  70. However, if necessary, you can edit the stored macro command to
  71. correct it.
  72.  
  73. .tc    Editing A Macro ....................................#
  74. Editing A Macro
  75. .ix   Editing
  76.  
  77. Macros recorded within Word Fugue can be edited on a character by
  78. character basis using the built-in macro editor. Enter the command Alt
  79. E to edit a macro from the current set of loaded macros. A list of the
  80. current macros will be displayed, and you select the one you want by
  81. use of the cursor keys to highlight the appropriate one, and pressing
  82. Return to select it. See Fig 13.3 for the macro selection window.
  83.  
  84. First, a prompt box will ask for a new name for the macro, which you
  85. can accept as is, or change. You should always include the activation
  86. letter in the name, for ease when replaying. The macros numbered 1 to
  87. 9 are activated by the numbers 1 to 9, while those numbered 10 to 35
  88. are activated by pressing the letters A to Z in that order.
  89.  
  90.  
  91.              ╔═══════════════════ Macro Name ════════════════════╗
  92.              ║1 - delete word left                               ║
  93.              ╚═══════════════════════════════════════════════════╝
  94.  
  95.                          Fig 13.1 - Edit Macro Name
  96. .tc1 Fig 13.1 - Edit Macro Name ............................#
  97.  
  98.  
  99. The macro will appear in another window. Most characters you type will
  100. be inserted literally into the macro, with the following exceptions.
  101.  
  102. It can be edited using the cursor arrow keys, and the <Del> or
  103. <Backspace> keys.  <CtrlBksp> will delete the macro. <Enter> will end
  104. the session in the macro editor. <Esc> will undo any changes made to
  105. the macro. Pressing Alt plus the number keys on the numeric keypad to
  106. code the decimal sequence of a character will enter that character.
  107. This makes it easy to enter those high order characters that do not
  108. appear on the keyboard. Consult your DOS manual for more information
  109. on entering alternate key strokes on your computer.
  110.  
  111. In case you need to enter any of these special keys as part of the
  112. macro, press the <ScrollLock> key to enter Literal mode. In this mode,
  113. all keystrokes will be inserted into the macro without any
  114. interpretation. In order to terminate the edit when in this mode, you
  115. will need to press <ScrollLock> again in order to enter the <Enter> or
  116. <ESC> characters.
  117.  
  118. .CP14
  119.  
  120.   ╔═════════════════════════ delete word left ══════════════════════════╗
  121.   ║ <CtrlLft><CtrlT>                                                    ║
  122.   ║                                                                     ║
  123.   ║                                                                     ║
  124.   ║                                                                     ║
  125.   ║                                                                     ║
  126.   ║                                                                     ║
  127.   ║                                                                     ║
  128.   ║                                                                     ║
  129.   ║                                                                     ║
  130.   ╚═════════════════════════════════════════════════════════ Command ═══╝
  131.  
  132.                          Fig 13.2 - Edit Macro Window
  133. .tc1 Fig 13.2 - Edit Macro Window ..........................#
  134.  
  135. The bottom right hand corner of the Edit Macro Window displays either
  136. Command or Literal to indicate in which mode the window is currently.
  137.  
  138. As you can see from Fig 13.2, the keystrokes are all given names when
  139. typed into the macro.
  140.  
  141. .tc    Saving A Macro File ................................#
  142. Saving A Macro File
  143. .ix   Saving macro file
  144.  
  145. If the macro you have recorded are to be of any use in later sessions
  146. of Word Fugue, you will need to save the file containing them. The
  147. command sequence Alt W will save the macro file. You will be prompted
  148. to enter a file name, with the current file name being displayed. You
  149. can either edit it, or press Return to accept it.
  150.  
  151. If the filename already exists, you will be prompted with Overwrite
  152. File? (Y/N) . If you enter Y the file will be overwritten. If you
  153. press N or ESC, the file will not be overwritten. In this situation
  154. you will need to enter the command again and type in a different file
  155. name.
  156.  
  157. .tc    Playing Back A Macro ...............................#
  158. Playing Back A Macro
  159. .ix   Playing back
  160.  
  161. Having set up a macro, you can now play it back. There are several
  162. commands available to do this.
  163.  
  164. .tc       Activate Macro 1 to 9 ...........................#
  165.   Activate Macro 1 to 9
  166.  
  167.   These macros can be activated by pressing Alt 1 to Alt 9 using the
  168.   numbers on the main keyboard above the letters. (Not the numeric key
  169.   pad - they will not work!!). You should place your most often used
  170.   macros in slots 1 to 9, since they are the easiest to activate.
  171.  
  172. .tc       Activate Macro ..................................#
  173.   Activate Macro
  174. .ix   Activation
  175.  
  176.   This command waits for the next keystroke, and if it is a macro
  177.   identifier, activates that macro. Press Alt M or ESC (Wordstar
  178.   compatible command). The top line will display choose macro to
  179.   apply if you pause before entering the macro identifier. If you
  180.   enter 0 to 9 or A t